home *** CD-ROM | disk | FTP | other *** search
/ Best of Shareware / Best of PC Windows Shareware 1.0 - Wayzata Technology (7111) (1993).iso / mac / DOS / UTILITY / FFF39 / FFF.DOC < prev    next >
Text File  |  1992-04-01  |  44KB  |  1,001 lines
  1.  
  2.  
  3.                                    File Finder Pack
  4.                                      Version 3.8
  5.                                        04-01-92
  6.                                           by
  7.                                        Jim Derr
  8.  
  9.                                       Member of
  10.                         Association of Shareware Professionals
  11.                                  CSERVE ID 76266,2634
  12.  
  13.  
  14.  
  15.  
  16.         HARDWARE SOFTWARE REQUIREMENTS  . . . . . . . . . . . . . . . . .    3
  17.  
  18.         QUICK START . . . . . . . . . . . . . . . . . . . . . . . . . . .    3
  19.  
  20.         PERFORMING A FUZZY SEARCH . . . . . . . . . . . . . . . . . . . .    3
  21.  
  22.         CONFIGURING THE FFF.EXE PROGRAM . . . . . . . . . . . . . . . . .    5
  23.  
  24.         CONFIGURING THE FF2.COM PROGRAM . . . . . . . . . . . . . . . . .    9
  25.  
  26.         MEMORY USAGE IN THE FFF.EXE PROGRAM . . . . . . . . . . . . . . .   10
  27.  
  28.         FF2 PROGRAM . . . . . . . . . . . . . . . . . . . . . . . . . . .   11
  29.  
  30.         FFF PROGRAM . . . . . . . . . . . . . . . . . . . . . . . . . . .   16
  31.  
  32.         FFF HOT KEYS  . . . . . . . . . . . . . . . . . . . . . . . . . .   20
  33.  
  34.         MEMORY SWAPPING OPTION IN FFF . . . . . . . . . . . . . . . . . .   23
  35.  
  36.         MONOCHROME MONITORS . . . . . . . . . . . . . . . . . . . . . . .   23
  37.  
  38.         MISC. INFORMATION . . . . . . . . . . . . . . . . . . . . . . . .   23
  39.  
  40.         THE SGREP PROGRAM . . . . . . . . . . . . . . . . . . . . . . . .   24
  41.  
  42.         REVISION HISTORY  . . . . . . . . . . . . . . . . . . . . . . . .   26
  43.  
  44.         INDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   27
  45.  
  46.  
  47.  
  48.                           FileFinder Version 3.6 User Manual           Page-3-
  49.  
  50.         Please note this is a shareware  product.  If you find these utilities
  51.         useful  please register  and keep  shareware alive.   Only  registered
  52.         users will be supported.  The fee is small and not unreasonable.
  53.  
  54.                             HARDWARE SOFTWARE REQUIREMENTS
  55.  
  56.         Both FF2 and  FFF can be run  on any DOS based  PC having a  CGA, MDA,
  57.         EGA, VGA, or HERC monitor.
  58.         The DOS  operating system must be  3.1 or greater.   Both program will
  59.         also operate correctly  in the DOS  compatibility box  of OS/2 1.2  or
  60.         greater.  Token ring networks or Novell networks are also supported.
  61.         DOS memory  requirements range from a  low of 160K  to a high  of 400K
  62.         depending on how the FFF program is configured.
  63.  
  64.                                      QUICK START
  65.         FF2 and FFF use basically the same format for the command line option.
  66.         All  command  line  parameters MUST  be  separated by  blanks  and all
  67.         options  MUST begin with  a forward slash  /.  The  options may appear
  68.         anywhere   on the command  line.  The  format of the  command line for
  69.         both programs is:
  70.  
  71.         FFx [options]  [[drives:] [filespec]] [options]
  72.  
  73.         If the drives parameter  is omitted the programs will search  all hard
  74.         drives that  can be identified.   If the drives  parameter is included
  75.         then  only the  drives specified  will be  searched. (PLEASE  NOTE THE
  76.         COLON MUST BE ENTERED AFTER THE DRIVE LETTERS).
  77.  
  78.                               PERFORMING A FUZZY SEARCH
  79.  
  80.         Beginning  with this  release, you  can also  perform a  fuzzy search.
  81.         This is  useful if you are trying to locate  a file but don't know the
  82.         exact filename.  The fuzzz search routine will attempt to locate files
  83.         that sound like the filename entered on the command line.  To indicate
  84.         that you want a fuzzy search  performed place the ~ character in front
  85.         of the filename.  PLEASE  NOTE: WHEN PERFORMING A FUZZY SEARCH  DO NOT
  86.         INCLUDE A FILE EXTENSION.  See the examples below.
  87.  
  88.         If the colon is entered without any drive letter preceding it then FFF
  89.         and FF2 will only search for files on the current default disk drive.
  90.  
  91.         For example:
  92.  
  93.         FFF : *.bat
  94.  
  95.         This will search for all files on the current default  drive that have
  96.         a file extension of bat.
  97.  
  98.         Multiple filespecs  may be entered  along with  multiple drives.   For
  99.         example:
  100.  
  101.  
  102.  
  103.                           FileFinder Version 3.6 User Manual           Page-4-
  104.  
  105.         FF2  *.BAK CD: \UTILITY\*.COM  DE: \TEMP\*.*  C:\JIM\*.*
  106.  
  107.         This example will:
  108.         1)   Find all files that have a  file extension of BAK that resides on
  109.              any identifiable hard drive.
  110.  
  111.         2)   Find all files  that have a file extension of  COM in the UTILITY
  112.              directory or any sub-directory of  the UTILITY directory ONLY  ON
  113.              HARD DRIVES C AND D.
  114.  
  115.         3)   Find all  files that reside  in the  TEMP directory  or any  sub-
  116.              directory of the TEMP directory ONLY ON HARD DRIVES D AND E.
  117.  
  118.         4)   Find  all files  that reside  in the  JIM directory  or  any sub-
  119.              directory of the JIM directory ONLY ON THE C DRIVE.
  120.  
  121.         FFF  ~QRT
  122.  
  123.         Perform a  fuzzy search looking for  all files that sound  like qtr on
  124.         all drives.
  125.  
  126.         FFF  ~QTR  *.COM
  127.  
  128.         Peroform the same fuzzy search  as above, in addition locate  all .COM
  129.         files.
  130.  
  131.         Any options that appear on the command line are active  for all search
  132.         operations.
  133.  
  134.  
  135.  
  136.                           FileFinder Version 3.6 User Manual           Page-5-
  137.  
  138.                            CONFIGURING THE FFF.EXE PROGRAM
  139.  
  140.         The FFF.EXE program has  numerous configurable options.   To configure
  141.         the FFF.EXE program the configuration program FFFCFG.EXE must  be run.
  142.         Simply enter FFFCFG at the DOS command prompt  and the following items
  143.         will appear:
  144.  
  145.         FFF configuration program Version 3.6
  146.  
  147.         ENTER THE FULL PATH NAME OF THE FFF.EXE PROGRAM TO MODIFY.
  148.  
  149.         FFF-PGM->
  150.              (Enter the full path name of the FFF.EXE program to configure.)
  151.              (I.E. C:\UTILITY\FFF.EXE)
  152.  
  153.         Do you have a serial number to install? Y or N->
  154.              (Respond  Y to  this  prompt  if  you have  a  serial  number  to
  155.         install.)
  156.              (Installing the serial number will remove the shareware screen.)
  157.  
  158.         ENTER YOUR SERIAL NUMBER ON THE LINE BELOW
  159.         SERIAL#=
  160.              (Enter your serial number here.)
  161.  
  162.         ENTER WHO FFF IS REGISTERED TO ON THE LINE BELOW
  163.         REGISTERED NAME->
  164.              (Enter your name or your company name here.)
  165.  
  166.         ENTER THE NAME OF THE EDITOR PROGRAM TO USE ON THE LINE BELOW
  167.         EDIT-PGM->Q.EXE
  168.              (Enter the name of the editor program you want FFF to invoke.)
  169.  
  170.  
  171.         ENTER THE NAME OF THE WORDPROCESSOR PROGRAM TO USE ON THE LINE BELOW
  172.         WORD-PGM->D:\WP51\WP.EXE
  173.              (Enter  the name  of the  wordprocessor program  you wish  FFF to
  174.              invoke.)
  175.  
  176.  
  177.         ENTER THE NAME OF THE LIST PROGRAM TO USE ON THE LINE BELOW
  178.         LIST-PGM->LIST.COM
  179.              (Enter the name of the list program to invoke.)
  180.  
  181.         ENTER THE NAME OF THE SHEZ PROGRAM TO USE ON THE LINE BELOW
  182.         SHEZ-PGM->C:\UTILITY\SHEZ.EXE
  183.              (Enter the full path name where FFF can find the SHEZ program.)
  184.              (Leave blank if you don't need to invoke SHEZ.)
  185.  
  186.         FFF's current search default is to search all hard drives.
  187.         Do you wish CHANGE this default? Y or N->
  188.              (Respond Y if you wish to change this default.)
  189.  
  190.  
  191.  
  192.                           FileFinder Version 3.6 User Manual           Page-6-
  193.  
  194.  
  195.         Enter an  A to search  All drives or  a C to  search only  the Current
  196.         drive.
  197.         Enter A or C->
  198.  
  199.  
  200.  
  201.                           FileFinder Version 3.6 User Manual           Page-7-
  202.  
  203.         FFF is configured to not to search networked drives.
  204.  
  205.  
  206.         Do you wish to also search any networked drives found?
  207.         Enter Y or N->
  208.              (Entering a Y will search for networked drives.)
  209.  
  210.         FFF is configured to display 43 rows on the screen
  211.  
  212.         Enter 0 to use default number of rows on the screen --or--
  213.         enter 25,43, or 50 to set the default number of lines to display
  214.         Enter 0,25,43, or 50-->
  215.  
  216.  
  217.         FFF has the ability to swap 90 of its code to either XMS, EMS memory
  218.         or  to  disk if  XMS  or  EMS is  not  available.    Currently FFF  is
  219.         configured to:
  220.         Use the swapping feature.
  221.  
  222.         Do you wish to use the swapping feature? Y or N->
  223.  
  224.         Do you want FFF to pause after running a program that has been
  225.         specified by using the R or CTRL-R option?
  226.         PAUSE after running a program? Y or N->
  227.  
  228.         FFF can display files in one of two formats as shown below
  229.         1) 9107  10/02/90  08:00:00  ----   MIXED    DOC  D:\MASM\
  230.         2) 9107  10/02/90  08:00:00  ----   D:\MASM\MIXED.DOC
  231.  
  232.         Enter a 1 or a 2 to indicate how you want FFF to display files.
  233.         ENTER a 1 or a 2->1
  234.  
  235.         FFF is currently set to handle a maximum of 4,000 files
  236.         You may alter this value from 1000 to 9000 files.
  237.         INCREASING THE NUMBER OF FILES WILL CAUSE FFF TO USE MORE DOS MEMORY
  238.         Enter max number of files to handle->3000
  239.  
  240.         FFF is currently set to handle a maximum of 300
  241.         unique directory names.
  242.         You may alter this value from 100 to 500.
  243.         INCREASING THE NUMBER OF UNIQUE DIRECTORY'S
  244.         WILL CAUSE FFF TO USE MORE DOS MEMORY
  245.         Enter max number of unique dirs to handle->300
  246.  
  247.         Do you want the ENTER key to exit FFF and drop you off into
  248.         currently highlighted DISK: and Directory?
  249.         Allow ENTER key Y or N->Y
  250.  
  251.  
  252.         Do you want file over write warnings displayed when copying
  253.  
  254.  
  255.  
  256.                           FileFinder Version 3.6 User Manual           Page-8-
  257.  
  258.  
  259.         tagged files?
  260.  
  261.         Overwrite Warnings Y or N->Y
  262.         (NORMALLY  FFF WILL DISPLAY  A WARNING MESSAGE  WHEN YOU  ARE ABOUT TO
  263.         OVER-WRITE AN EXISTING FILE.  IF YOU RESPOND N TO THIS PROMPT FFF WILL
  264.         NOT DISPLAY THE WARNING MESSAGE WHEN COPYING TAGGED FILES.)
  265.  
  266.  
  267.         Customize Colors Y or N->N
  268.              (Enter a Y to change the default color scheme.)
  269.  
  270.  
  271.  
  272.                           FileFinder Version 3.6 User Manual           Page-9-
  273.  
  274.                            CONFIGURING THE FF2.COM PROGRAM
  275.  
  276.         To configure the FF2.COM  program enter the /CFG option on the command
  277.         line when starting the FF2 program.  I.E. FF2 /CFG
  278.  
  279.         The following prompts will appear:
  280.  
  281.         Searching for local drive(s). Found CDEF.
  282.         Do you have a serial number to install? Y or N->Y
  283.  
  284.         Enter your serial number on the line below.
  285.          SERIAL#=
  286.  
  287.         ENTER WHO FF2 IS REGISTERED TO ON THE LINE BELOW
  288.          REGISTERED NAME->
  289.  
  290.         FF2.COM is currently set to:
  291.         Search all identified hard drives.
  292.         FF2.COM will not search for network drives.
  293.         Use high speed screen writing routines.
  294.  
  295.         Set FF2.COM to search All local drives or only the Current drive?
  296.         Enter an A or C->
  297.  
  298.         Set FF2.COM to also search any network drives?
  299.         Enter a Y or N->
  300.  
  301.         Set FF2.COM to use legal BIOS routines when writing to the screen?
  302.         Enter a Y or N->
  303.  
  304.  
  305.  
  306.                           FileFinder Version 3.6 User Manual          Page-10-
  307.  
  308.                          MEMORY USAGE IN THE FFF.EXE PROGRAM
  309.  
  310.         The  FFFCFG program now allows you set  the number of files and unique
  311.         directories that  the FFF program can  handle.  The FFF  program comes
  312.         preconfigured to  handle 3000  files and 300  unique directory  names.
  313.         Under this configuration  the FFF program  uses approximately  317,000
  314.         bytes of memory.  If you increase or decrease the  number of files FFF
  315.         can handle it's  memory usage increases or  decreases by 49  bytes for
  316.         each additional file you tell FFF to handle.
  317.  
  318.  
  319.         If you increase  or decrease the number of  unique directory names FFF
  320.         can handle its memory usage increases or decreases by 70 bytes.
  321.  
  322.  
  323.         To  determine the amount  of memory FFF  will need,  use the following
  324.         formula:
  325.  
  326.              149300 + (49 * number of files  to handle) + (70 * number of dirs
  327.              to handle)
  328.  
  329.  
  330.         For example, the memory requirements for FFF to handle 5000 files  and
  331.         400 unique directories would be:
  332.  
  333.              149300 + (49 * 5000) + (70 * 400) = 422,300
  334.  
  335.  
  336.  
  337.                           FileFinder Version 3.6 User Manual          Page-11-
  338.  
  339.                                      FF2 PROGRAM
  340.         This program will find files on your hard disk.  It as fashioned after
  341.         the whereis program but has more features.
  342.  
  343.         Format is:
  344.  
  345.         FF2 [options] [[drives:] [filespec]] [options]
  346.  
  347.         Where options are:
  348.         /C        comma delimited listing
  349.         /R        raw listing - full path name only
  350.         /S        short listing - filename.ext only
  351.         /B        list in bat file format
  352.         /P        pause when screen is full
  353.         /Q        quite mode
  354.         /I        also look inside archive files
  355.         /A        only look inside archive files
  356.         /E        Extended Directory Search
  357.         /G        Greater or Equal to mm-dd-yy
  358.         /L        Less or Equal to mm-dd-yy
  359.         /SD       Single Directory search only (do not recurse)
  360.         /1        stop after finding one file
  361.                   errorlevel 1 returned if no files found
  362.                   errorlevel 0 returned if files are found
  363.         /Z[RHSA]  Show files with specified attributes
  364.         /X"cmd"   execute a cmd against all files found
  365.         /@        Prompt for options.
  366.         /NN       No-Network drive search
  367.         /LN       Look for network drives
  368.         /CFG      Configure the FF2 Program.
  369.  
  370.         The  filespec's that are specified  on the command  line can include a
  371.         disk and directory. If a  disk and or directory is specified  than the
  372.         search  will be restricted to the specified disk and directory and any
  373.         sub-directories under  the specified  directory.   Each  filespec  can
  374.         contain different starting disks and directories.
  375.  
  376.         When specifying  the file  to  search for  FF2  has a  quick  complete
  377.         algorithm.  If you do not include a period in the file ex   tension
  378.         FF2 will  expand the filespec using  the wildcard character ?  for the
  379.         remainder of  the filespec.   For example if  you entered FF2  AB, FF2
  380.         will expand  the filespec to AB??????.???.   If you enter FF2 C:\BAT\B
  381.         FF2  will expand the filespec to  C:\BAT\B???????.???.  However if you
  382.         enter  FF2 B.* , FF2 will not alter  the filespec since you included a
  383.         period in the filespec.
  384.  
  385.         FF2 also has an expanded wild card search algorithm. If you include an
  386.         * on  both sides of  the filename,  FF2 will find  all files  that
  387.         contain  the  characters  entered  between  the *'s  anywhere  in  the
  388.         filename. For example:
  389.  
  390.  
  391.  
  392.                           FileFinder Version 3.6 User Manual          Page-12-
  393.  
  394.         FF2 *inst*
  395.  
  396.         This will find all files that contain inst somewhere in the filename.
  397.  
  398.         I.E. D:\ANY\PINST.BAT
  399.              C:\ONE\PCINSTAL.BAT
  400.              C:\TWO\INSTALL.COM
  401.  
  402.         To  find files  with  no  extension include  the  period  but no  file
  403.         extension. I.E.  FF2 *me*.
  404.  
  405.         If no  disk or directory is  included with the filespec  than all hard
  406.         disks will be searched.
  407.  
  408.  
  409.  
  410.                           FileFinder Version 3.6 User Manual          Page-13-
  411.  
  412.         FF2 now has the capability to automatically identify all hard disks on
  413.         your  system.  You  can over-ride this  automatic detection by setting
  414.         the environment variable FF to the disk letter your wish the search to
  415.         be performed on.For  example.  SET FF=CD tells FF2 to search the C and
  416.         D drives if  you have  not specified  a disk  in the  filespec on  the
  417.         command line.
  418.  
  419.         All  output  from FF2  can be  redirected or  piped  by using  the DOS
  420.         redirect and pipe characters.
  421.  
  422.         The default output  produced by FF2  file-size, file-date,  file-time,
  423.         disk:\directory\filename.file-ext. This  can be  changed by  using the
  424.         following command line options:
  425.  
  426.         /C   Produces a comma  delimited listing, this listing can be imported
  427.              into most spreadsheet and database programs.
  428.  
  429.         /R   Produces a raw listing containing disk:\directory\fn.ext only.
  430.  
  431.         /S   Produces a short listing containing filename.ext only.
  432.  
  433.         /B   Produces a  listing that can be used as a bat file. The output is
  434.              as follows:
  435.              %1 filename.ext %2 %3 %4 %5 %6 %7 %8 %9
  436.  
  437.         /P   Will case a pause when the screen is full.
  438.  
  439.         /Q   Quite mode no output produced but results can be tested  by using
  440.              the if errorlevel command in a .bat file.
  441.  
  442.         /I   This option tells  FF2 to also look inside any  archive files for
  443.              the  indicated files.   The archive files  that are supported are
  444.              ZIP, ARC, ARJ, ZOO, PAK, and LZH files.
  445.  
  446.         /A   This option tells FF2 to  ONLY look inside archive files  for the
  447.              indicated files.
  448.  
  449.         /1   This  option tells FF2  to stop looking for  files after it finds
  450.              the first file that matches the specified pattern.
  451.  
  452.         /E   To increase the file search  process FF2 normally only looks  for
  453.              directories  that do not  contain a  file extension.   Using this
  454.              option  tells  FF2 to  also  look  for directories  that  contain
  455.              directory names with extensions.
  456.  
  457.         /G   This  option allows  you to limit  the file search  to files that
  458.              have a filedate Greater  than or Equal to the date specified. The
  459.              format is /Gmm-dd-yy.
  460.              I.E. /G01-01-90    or   /G1-1-90  will  list files  that  have  a
  461.              filedate greater than or equal to 1-1-90.
  462.              (Note this option may be combined with the /L option to specify a
  463.  
  464.  
  465.  
  466.                           FileFinder Version 3.6 User Manual          Page-14-
  467.  
  468.              date range)
  469.  
  470.         /L   This option allows  you to  limit the file  search to files  that
  471.              have a  filedate Less than  or Equal  to the date  specified. The
  472.              format is /Lmm-dd-yy.
  473.              I.E.  /L01-01-90   or    /L1-1-90 will  list  files  that have  a
  474.              filedate less than or equal to 1-1-90.
  475.              (Note this option may be combined with the /G option to specify a
  476.              date range)
  477.  
  478.         /Z[RHSA]
  479.              This  option allows you  to limit the  file search to  files that
  480.              have specific attributes.  For example, specifying /ZA  will list
  481.              files that have the archive attribute, /ZRH  will list files that
  482.              have the read-only attribute OR the hidden attribute set.
  483.              ***PLEASE  NOTE IF YOU  SPECIFY THE  /A OR  /I OPTIONS  THAN THIS
  484.              OPTION IS IGNORED***
  485.  
  486.         /SD  This  option informs FF2  to only  search the directory  that was
  487.              specified on the command line  and not to search any  directories
  488.              that exist under the specified directory.
  489.  
  490.  
  491.  
  492.                           FileFinder Version 3.6 User Manual          Page-15-
  493.  
  494.         /X"cmd"
  495.              This options  allows  you to  tell  FF2  to execute  a  specified
  496.              against all files that are found.
  497.              For Example:
  498.  
  499.              /X"del &"
  500.  
  501.              will execute the delete command against all file that were found.
  502.              The command can be any DOS command or another program.   FF2 will
  503.              insert the disk:\dir\fn.fext of  the found file into the  command
  504.              where you place the & character.
  505.  
  506.              For example if you specify the following:
  507.  
  508.              /X"grep any & -s"
  509.  
  510.              and  FF2  finds  the  file c:\data\any.doc  it  will  execute the
  511.              following command:
  512.  
  513.              grep any c:\data\any.doc -s
  514.  
  515.              If  you do  not  put the  & in  then  FF2 will  insert the  found
  516.              filespec at the first blank in the command you specify, or at the
  517.              end of the command if no blanks exist.
  518.  
  519.         /@   This  options instructs FF2  to prompt  the user for  the command
  520.              line parameters.  PLEASE NOTE NO OTHER PARAMETERS  ARE ALLOWED ON
  521.              THE COMMAND  LINE IF THIS OPTION  IS SPECIFIED.  The  use of this
  522.              option  also allows the user  to use the  DOS redirect feature to
  523.              feed FF2 it's parameters.
  524.  
  525.              For example:  FF2 /@ < FF2.DAT
  526.  
  527.              This  instructs FF2 to  read its  parameters from the  file names
  528.         FF2.DAT.
  529.  
  530.         /NN  This option allows you to bypass the searching of Network drives.
  531.              If  you configured FF2  to search for network  drives you may use
  532.              this option to temporarily bypass the network drive search.
  533.  
  534.         /LN  This option  allow you to search for files on Network drives.  If
  535.              you  configured FF2  to ignore  network drives  you may  use this
  536.              options to temporarily look for files on any networked drives.
  537.  
  538.         /CFG This  options allows you  to configure the  FF2 program with your
  539.         own personal defaults.
  540.  
  541.  
  542.  
  543.                           FileFinder Version 3.6 User Manual          Page-16-
  544.  
  545.                                      FFF PROGRAM
  546.  
  547.         This  program will find files on your hard disk, and present them in a
  548.         scrollable list.
  549.  
  550.         Format is FFF [options] [[drives:] [filespec]] [options]
  551.  
  552.         Where options are:
  553.         /2   25 line mode display
  554.         /4   43 line mode display
  555.         /5   50 line mode display
  556.         /d   Search for dup files. (filename.ext only)
  557.         /D   Search for dup files. (filename.ext and file size)
  558.         /E   Extended Directory Search
  559.         /G   Greater or Equal to mm-dd-yy
  560.         /L   Less or Equal to mm-dd-yy
  561.         /I   also look inside archive files
  562.         /A   only look inside archive files
  563.              (THE  ARCHIVE FILES  THAT ARE  SUPPORTED ARE  ZIP,ARC,ARJ,PAK AND
  564.              LZH)
  565.         /Z[RHSA]
  566.              Show files with specified attributes
  567.         /SD  Single Directory search only (do not recurse)
  568.         /NN  No-Network drive search
  569.         /LN  Look for network drives
  570.         /@   Prompt for options.
  571.  
  572.  
  573.         /I   This option tells  FFF to also look inside any  archive files for
  574.              the indicated files.   The archive files  that are supported  are
  575.              ZIP, ARC, ARJ, ZOO, PAK, and LZH files.
  576.  
  577.         /A   This option tells FFF to ONLY  look inside archive files for  the
  578.              indicated files.
  579.  
  580.         /d   This option tells FFF to search and display duplicate files. Only
  581.              the filename.ext will be used to determine duplicates.
  582.  
  583.         /D   This option is the  same as the /d option except the filename.ext
  584.              and file size will be used to determine if a file is a dup.
  585.  
  586.         /E   To  increase the file search process  FFF normally only looks for
  587.              directories that  do not contain  a file  extension.  Using  this
  588.              option tells FFF to also look for directories that contain
  589.                  directory names with extensions.
  590.  
  591.         /G   This option  allows you to  limit the file  search to  files that
  592.              have a filedate Greater than or Equal to the date specified.  The
  593.              format is /Gmm-dd-yy.
  594.              I.E.  /G01-01-90    or   /G1-1-90  will  list files  that  have a
  595.         filedate greater than or equal to 1-1-90.
  596.  
  597.  
  598.  
  599.                           FileFinder Version 3.6 User Manual          Page-17-
  600.  
  601.              (Note this option may be combined with the /L option to specify a
  602.         date range)
  603.  
  604.         /L   This option  allows you to  limit the  file search to  files that
  605.              have  a filedate Less  than or Equal  to the  date specified. The
  606.              format is /Lmm-dd-yy.
  607.              I.E. /L01-01-90    or   /L1-1-90  will  list files  that  have  a
  608.              filedate less than or equal to 1-1-90.
  609.              (Note this option may be combined with the /G option to specify a
  610.         date range)
  611.  
  612.         /SD  This  option informs FF2  to only  search the directory  that was
  613.              specified on the command line  and not to search any  directories
  614.              that exist under the specified directory.
  615.  
  616.  
  617.  
  618.                           FileFinder Version 3.6 User Manual          Page-18-
  619.  
  620.         /Z[RHSA]
  621.              This  option allows  you to limit  the file search  to files that
  622.              have specific attributes.  For example,  specifying /ZA will list
  623.              files that have the archive attribute, /ZRH  will list files that
  624.              have the read-only attribute OR the hidden attribute set.
  625.              **PLEASE NOTE IF YOU SPECIFY THE /A OR /I OPTION THAN THIS OPTION
  626.              IS IGNORED.**
  627.  
  628.         /NN  This option allows you to bypass the searching of Network drives.
  629.              If you configured  FF2 to search for  network drives you may  use
  630.              this option to temporarily bypass the network drive search.
  631.  
  632.         /LN  This option allow you to search  for files on Network drives.  If
  633.              you  configured FF2  to ignore  network drives  you may  use this
  634.              options to temporarily look for files on any networked drives.
  635.  
  636.  
  637.         /@   This  options instructs FFF  to prompt  the user for  the command
  638.              line parameters. PLEASE NOTE  NO OTHER PARAMETERS ARE ALLOWED  ON
  639.              THE COMMAND  LINE IF THIS OPTION  IS SPECIFIED.  The  use of this
  640.              option also allows  the user to use  the DOS redirect feature  to
  641.              feed FF2 it's parameters.
  642.  
  643.              For example:  FFF /@ < FFF.DAT
  644.  
  645.              This  instructs FFF to  read its  parameters from the  file names
  646.         FFF.DAT.
  647.  
  648.  
  649.  
  650.                           FileFinder Version 3.6 User Manual          Page-19-
  651.  
  652.         The filespec's that are  specified on the  command line can include  a
  653.         disk and directory. If a  disk and or directory is specified  than the
  654.         search will be restricted  to the specified disk and directory and any
  655.         sub-directories under  the specified  directory.   Each  filespec  can
  656.         contain different starting disks and directories.
  657.  
  658.         When  specifying the  file  to search  for  FFF has  a  quick complete
  659.         algorithm.  If you do not include a period and  the file extension FFF
  660.         will expand  the  filespec using  the  wildcard  character ?  for  the
  661.         remainder of  the filespec.   For example if  you entered FFF  AB, FFF
  662.         will  expand the filespec to AB??????.???.   If you enter FFF C:\BAT\B
  663.         FFF will expand the filespec  to C:\BAT\B???????.???.  However if  you
  664.         enter FFF B.* , FFF will  not alter the filespec since you  included a
  665.         period in the filespec.
  666.  
  667.         FFF also has an expanded wild card search algorithm. If you include an
  668.         *  on both sides  of the  filename, FFF will  find all  files that
  669.         contain  the  characters  entered  between  the  *'s  anywhere  in the
  670.         filename. For example:
  671.  
  672.         FFF *inst*
  673.  
  674.         This will find all files that contain inst somewhere in the filename.
  675.              I.E  D:\ANY\PINST.BAT
  676.                   C:\ONE\PCINSTAL.BAT
  677.                   C:\TWO\INSTALL.COM
  678.  
  679.         To  find  files with  no  extension include  the  period  but no  file
  680.         extension. I.E.  FFF *me*.
  681.  
  682.         If no  disk or directory is  included with the filespec  than all hard
  683.         disks will be searched.
  684.  
  685.         FFF now has the capability to automatically identify all hard disks on
  686.         your  system.  You  can over-ride this  automatic detection by setting
  687.         the environment variable FF to the disk letter your wish the search to
  688.         be performed on.
  689.  
  690.         For example.  SET FF=CD tells FFF to search the C and D drives if  you
  691.         have not specified a disk in the filespec on the command line.
  692.  
  693.  
  694.         FFF will display  all the files it found, up  to it's internal maximum
  695.         of 3000 files, on the screen in a scrollable list.  You can use the
  696.         cursor  keys, Pgup, Pgdn,  HOME, END, CTL-HOME,  and CTL-END to scroll
  697.         the list.  Pressing the ESC key will exit the program.
  698.  
  699.  
  700.  
  701.                           FileFinder Version 3.6 User Manual          Page-20-
  702.  
  703.                                      FFF HOT KEYS
  704.  
  705.         ALT-X
  706.         ALT-Q
  707.         ESC  Any of these keys will immediately exit FFF.
  708.  
  709.         F1   will display the help panel.
  710.  
  711.         F10  This will  allow you to sort  the file list that  is displayed on
  712.              the screen.  The list can be  sorted by filename, file extension,
  713.              file date, or disk:\dir location.
  714.  
  715.         ENTER or
  716.         G    Pressing the  G or ENTER key  will exit the FFF  program and will
  717.              change the default  disk and directory to the one   that contains
  718.              the file currently highlighted on the screen.
  719.  
  720.              (THE ENTER KEY WILL ONLY FUNCTION IF  THE USER SPECIFICALLY TELLS
  721.              THE FFFCFG PROGRAM TO ACTIVATE THE ENTER KEY.)
  722.  
  723.         R    Pressing the R key allows you to run any program you wish against
  724.              the  currently highlighted file.   A window  will pop-up in which
  725.              you must  enter  program name  that  you wish  to  execute.   The
  726.              program can be a DOS  internal program, i.e. del, rename,  or any
  727.              EXE, COM, or BAT file. When  you enter the program to execute you
  728.              must  tell FFF  where to  place the  highlighted filename  in the
  729.              command  by using the ! character as  a place holder.  Before FFF
  730.              runs the command  the ! will  be replaced with   the  highlighted
  731.              filename.
  732.  
  733.         S    Pressing the S key will invoke my  Compressed file manager called
  734.              SHEZ. The  Program file SHEZ.EXE must be in the DOS path for this
  735.              options to function.
  736.  
  737.         E    Pressing the E key will execute the program or BAT file currently
  738.              highlighted  on the  screen. Before the  Program is  executed FFF
  739.              will prompt you for any command  line parameters that you want to
  740.              pass  to  the  program.  It will  then  change  to  the  disk and
  741.              directory that the  program is contained  in, unload itself  from
  742.              memory and execute the program.
  743.  
  744.         T    The T key will toggle the tagged status of the highlighted item.
  745.  
  746.         U    The U key will untag all tagged items.
  747.  
  748.         ALT-D     will delete the currently highlighted file.
  749.  
  750.         ALT-L     The ALT-L key will invoke  Vern Buerg's List program on  the
  751.                   highlighted file.  The list.com  program must be in the  DOS
  752.                   path for this option to function.
  753.  
  754.  
  755.  
  756.                           FileFinder Version 3.6 User Manual          Page-21-
  757.  
  758.         ALT-E     The  ALT-E key  will invoke  an editor  of your  choice. The
  759.                   default editor is  QEdit by Sammy Mitchell,  however you can
  760.                   change this default by using the FFFCFG program.
  761.  
  762.         ALT-C
  763.         ALT-O     The  ALT-O  or  ALT-C  keys  will  allow  you  to  copy  the
  764.                   highlighted file.   A window  will appear prompting  you for
  765.                   the destination drive and directory.
  766.  
  767.  
  768.         ALT-W     The ALT-W key will invoke  a word processor of your  choice.
  769.                   The wordprocesser program name must be set using  the FFFCFG
  770.                   program before this options can be used.
  771.  
  772.         ALT-T     Write out the displayed file list to the file FFF.LST.
  773.  
  774.         ALT-P     Print out the displayed file list to device STDPRN.
  775.  
  776.         ALT-I     Display  a windows  containing configuration and  file stats
  777.         information.
  778.  
  779.         CTL-D     will delete all tagged files.
  780.  
  781.         CTL-C
  782.         CTL-O     The  CTL-O or  CTL-C keys  will allow  you to  copy the  all
  783.                   tagged  files.  A  window will appear  prompting you for the
  784.                   destination drive and directory.
  785.  
  786.         CTL-R     Pressing  the CTL-R key  allows you  to run any  program you
  787.                   wish  against all  tagged files.   A  window will  pop-up in
  788.                   which you must enter  program name that you wish to execute.
  789.                   The program can be a DOS internal program, i.e. del, rename,
  790.                   or any EXE, COM, or BAT file.  When you enter the program to
  791.                   execute you must tell FFF where to place the tagged filename
  792.                   in  the command by using the !  character as a place holder.
  793.                   Before FFF runs the command the  ! will be replaced with the
  794.                   filename.
  795.  
  796.         CTL-T     Write out a list of all tagged files to file FFF.LST.
  797.  
  798.         CTL-P     Print out a list of all tagged files to device STDPRN.
  799.  
  800.         CTL-G     Pressing the CTL-G keys will  allow you to run the  included
  801.                   SGREP  program against a  group of  tagged files.   (See the
  802.                   section titled SGREP PROGRAM for more information)
  803.  
  804.         CAPS-LOCK
  805.              When the CAPS-LOCK key is active, a tagged  file status line will
  806.              be displayed on the bottom of the screen.  Pressing the CAPS-LOCK
  807.              key again will remove this status line.
  808.  
  809.  
  810.  
  811.                           FileFinder Version 3.6 User Manual          Page-22-
  812.  
  813.  
  814.  
  815.                           FileFinder Version 3.6 User Manual          Page-23-
  816.  
  817.                             MEMORY SWAPPING OPTION IN FFF
  818.         Beginning  with release  3.3  of the  FFF program,  a  memory swapping
  819.         ability  has been added.  When  invoking the Editor, SHEZ, shelling to
  820.         DOS, or invoking another program via the R or CTL-R functions, FFF can
  821.         optionally swap  90% of  its code  to either XMS,  EMS memory  (3.0 or
  822.         4.0), or to  disk if XMS or EMS memory is  not available.  This option
  823.         is  OFF  by  default.   It  can  be  turned  on  by using  the  FFFCFG
  824.         configuration  program.   Using  this option  allows you  to  run much
  825.         larger programs from within FFF than would be normally possible.   FFF
  826.         first tries XMS memory than EMS memory.
  827.  
  828.  
  829.                                  MONOCHROME MONITORS
  830.  
  831.         If you are using a  monochrome monitor and the screen does  not appear
  832.         correct set the environment variable MONO to a Y.  I.E. SET MONO=Y.
  833.  
  834.                                   MISC. INFORMATION
  835.  
  836.         Both FF2 and FFF are both DesQview aware.
  837.         Beginning with  version  3.4 both  FF2 and  FFF will  now also  search
  838.         directories that have hidden or system  attributes associated with the
  839.         directory.
  840.  
  841.  
  842.  
  843.                           FileFinder Version 3.6 User Manual          Page-24-
  844.  
  845.                                   THE SGREP PROGRAM
  846.  
  847.         The SGREP program, supplied with SHEZ, is used by SHEZ when the ALT-G
  848.         key is pressed, to scan member(s) of a compressed file for words or
  849.         phrases.  It is included in the SHEZ package for those user's that do
  850.         not have the FGREP program written by Chris Dunford.  While the SGREP
  851.         program performs the same function, it is not as fast or as powerful
  852.         as Chris Dunford's FGREP program.  When the ALT-G keys are pressed,
  853.         SHEZ first tries to locate the SGREP.COM program,  if it can not be
  854.         found SHEZ will than try to locate the FGREP.COM program.  Which ever
  855.         program is found will be the one SHEZ users to scan for text.
  856.  
  857.         The SGREP command line format uses a subset of the FGREP program to
  858.         maintain compatibility with FGREP.  SGREP does allow the user to
  859.         specify two target strings in the search argument.  These two target
  860.         strings are connected with an and, &, or or, '|' separator.  Thus
  861.         allowing the user to search for two different strings, or two strings
  862.         or words contained on the same line.  When the specific string is
  863.         found, the line in the file that contains the string is written to the
  864.         stdout DOS device, which is normally the display.  The output may be
  865.         redirected to a file or a printer using the normal DOS redirection
  866.         symbols.  The format of the SGREP command line is as follows:
  867.  
  868.         SGREP [options] "target(s)" {file(s)...|@file}
  869.  
  870.         Where options are:
  871.  
  872.              -f   display **FILE-NAME for finds only
  873.              -l   line numbers
  874.              -c   case sensitive search
  875.              -x   no logo
  876.              -e   return errorlevel only
  877.              -p   pause when screen is full
  878.              -v   verbose display output
  879.  
  880.         @file indicates an ascii file containing a list of file to process.
  881.         This list MUST include the complete file specification.  I.E. The
  882.         disk, directory, filename, and file extension.
  883.  
  884.         The target string(s) must be enclosed in quotes and special characters
  885.         can be specified as indicated below.
  886.  
  887.         Hex byte sequences can be used to search for special non-displayable
  888.         characters.  They are specified using a pair of hexadecimal bytes
  889.         preceded by a dollar sign,$.
  890.  
  891.         EXAMPLES: $23       include is the string #include
  892.                   $252.50   is the string %2.50
  893.                   $23$24$25 is the string #$%
  894.  
  895.         Two targets may be specified using the & and | characters to search
  896.  
  897.  
  898.  
  899.                           FileFinder Version 3.6 User Manual          Page-25-
  900.  
  901.         for two targets.  If the & is used the lines must contain
  902.         both targets.  If the | is used the lines must contain one of the
  903.         targets.
  904.  
  905.         Example:  "save|main"    line must have save or main to be listed.
  906.                   "save&main"    line must have save and main to be listed.
  907.  
  908.         The format of the SGREP command line is presented here for
  909.         documentation purposes only since SHEZ automatically invoked either
  910.         SGREP or FGREP itself using a predefined set of options.  SGREP may be
  911.         run from the DOS command prompt, or when using the ALT-Y command
  912.         option of SHEZ.
  913.  
  914.  
  915.  
  916.                           FileFinder Version 3.6 User Manual          Page-26-
  917.  
  918.                                    REVISION HISTORY
  919.  
  920.         v3.8 4/1/92  Added  CAPS-LOCK command  in FFF  to display  tagged file
  921.              status.
  922.              Increased speed of locating and identifying all hard drives.
  923.              Added SGREP program to search for text within tagged files.
  924.              Added ability to swap FFF program to XMS or EMS memory.
  925.              Added scroll bars to FFF display.
  926.              Added ALT-C command to copy single files.
  927.              Added CTL-C command to copy tagged files.
  928.              Added CTL-G  command  to run  SGREP program  against  a group  of
  929.              tagged files.
  930.  
  931.         v3.7 7/19/91  Corrected FFF  processing when  searching for  all files
  932.              when using the /i option.
  933.              Changed  the  FFFCFG  program  to  retain  previously  configured
  934.              colors.
  935.              Added the ability to perform a fuzzy search.
  936.              Added a configurable option  to turn the file over-write  warning
  937.              message off when copying tagged files.
  938.  
  939.         V3.6 5/6/91 - Corrected floating tags.
  940.              Added ALT-I to display config. and file stats.
  941.              Implemented new sort routine to speed up file sorting.
  942.              Added ALT-T, CTL-T commands to write out a file list.
  943.              Added ALT-P, CTL-P commands to print out a file list.
  944.              Added ability to configure FFF's colors.
  945.              Added ALT-X, and ALT-Q to exit FFF.
  946.              Added the ability to activate or deactivate the ENTER key.
  947.              Added the ability to configure FFF to handle up to 9000 files and
  948.              300 unique directory names.
  949.              When  invoking  the browse  program  via  the  ALT-L command,  if
  950.              swapping  is enabled FFF  will swap  itself out of  memory before
  951.              invoking the browse program.
  952.  
  953.  
  954.  
  955.                           FileFinder Version 3.6 User Manual          Page-27-
  956.  
  957.  
  958.                                         INDEX
  959.  
  960.         CONFIGURING THE FF2.COM PROGRAM . . . . . . . . . . . . . . . . . .  9
  961.         CONFIGURING THE FFF.EXE PROGRAM . . . . . . . . . . . . . . . . . .  5
  962.         FF2 command line options
  963.              /@ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  964.              /1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  965.              /A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  966.              /B . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  967.              /C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  968.              /E . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  969.              /G . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  970.              /I . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  971.              /L . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  972.              /P . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  973.              /Q . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  974.              /R . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  975.              /S . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  976.              /SD  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  977.         FFF command line options
  978.              /@ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
  979.              /2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
  980.              /4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
  981.              /5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
  982.              /A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
  983.              /d . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
  984.              /E . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
  985.              /G . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
  986.              /I . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
  987.              /L . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
  988.              /SD  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
  989.              /Z[RHSA] . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
  990.         FFF HOT KEYS  . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
  991.         FFF PROGRAM . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
  992.         MEMORY SWAPPING OPTION IN FFF . . . . . . . . . . . . . . . . . . . 23
  993.         MEMORY USAGE IN THE FFF.EXE PROGRAM . . . . . . . . . . . . . . . . 10
  994.         MONOCHROME MONITORS . . . . . . . . . . . . . . . . . . . . . . . . 23
  995.         PERFORMING A FUZZY SEARCH . . . . . . . . . . . . . . . . . . . . .  3
  996.         QUICK START . . . . . . . . . . . . . . . . . . . . . . . . . . . .  3
  997.         REVISION HISTORY  . . . . . . . . . . . . . . . . . . . . . . . . . 26
  998.  
  999.  
  1000.  
  1001.